home *** CD-ROM | disk | FTP | other *** search
/ Scene 96 / Scene 96 International Edition (Zyklop Software) (Disc 2) (1997).iso / programs / remus04e / remus.doc < prev    next >
Text File  |  1997-01-17  |  38KB  |  726 lines
  1.                        ┬┬──┐ ┬┬──┐ ┬┬──┬──┐ ┌┐    ┌┬──┐
  2.                        ││  │ ││    ││  │  │ ││  │ ││
  3.                        │├─┬┘ │├──  ││  │  │ ││  │ └┴─┬┐
  4.                        ││ └┐ ││    ││  │  │ ││  │    ││
  5.                        └┘  └ ┴┴──┘ └┘  ┴  ┴ └┴──┘ └──┴┘
  6.     ─────────────────────────────────────────────────────────────────────
  7.  
  8.                   Written by Roman Dolejsi (RDOS of DIMENSION)
  9.  
  10.                                        January 1, 1997
  11.                         Last update:   January 1, 1997
  12.  
  13.  
  14.        This is the documentation belonging to and explaining the use of
  15.  
  16.                              REMUS version 0.04e
  17.                    Universal sound card emulator for MS-DOS
  18.  
  19.  
  20.    TOPICS covered in this document:
  21.  
  22.      DISCLAIMER
  23.          APOLOGIZE
  24.      PURPOSE OF REMUS
  25.      REQUIREMENTS
  26.          INSTALLATION OF REMUS
  27.          REMUS IN ACTION
  28.          DIALOG LINE
  29.          AVAILABLE BASE CARDS
  30.          AVAILABLE EMULATIONS
  31.          GLOBAL EMULATION TABLE
  32.          SOUNDCARD AND EMULATION INFO
  33.          FUTURE PLANS
  34.          FREQUENTLY ASKED QUESTIONS
  35.          COPYRIGHT
  36.          WHERE TO FIND REMUS
  37.          THANX
  38.          CONTACTING ME
  39.  
  40.  
  41.  
  42. DISCLAIMER:
  43. -----------
  44.   Although REMUS has been tested on several systems, I cannot guarantee that it
  45. is bugless. Therefore I do not  take  responsibility for any damage directly or
  46. indirectly caused by  REMUS as a result of known/unknown errors in it or errors
  47. caused by its access to your devices.
  48.  
  49.  
  50. APOLOGIZE:
  51. ----------
  52.   Sorry, english is not my  native language. However, I wrote this nice docy in
  53. english without any help. I APOLOGIZE for any mistakes in the document. Take it
  54. easy... Nobody is perfect.. :-)
  55.  
  56.  
  57. PURPOSE OF REMUS:
  58. -----------------
  59.   REMUS is a sound card emulator for IBM PC and compatibles running MS-DOS. By
  60. emulation it will allow you to use products created for sound card you don't
  61. have. It is programmed to be used on as many cards as possible, but it is still
  62. in fairly alpha stage and don't expect any miracles.
  63.  
  64.  
  65. REQUIREMENTS:
  66. -------------
  67.   REMUS is coded in protected mode 386-assembler. You'll then need manager-free
  68. MS-DOS environment (ie. without Emm386, Qemm, 386max  or such memory managers).
  69. REMUS will run only  on computers with at least 2MB and less that 16MB RAM. I'm
  70. really  sorry  for  the  higher  limit but currently my manager will freeze due
  71. to unknown reason. You may also find useful to have some supported soundcard.
  72.  
  73.  
  74. INSTALLATION OF REMUS:
  75. -------------------------
  76.  
  77. - first  you have to make some directory on your drive. Then you have to unpack
  78.   there archive file RMSxyyz.ZIP.
  79.   (you probably did all this when you read these lines :-)
  80.  
  81. - REMUS pack should consist of these files:
  82.  
  83.     REMUS.EXE   - Main file - OPL player
  84.     REMUS.DOC   - Documentation for REMUS (this file)
  85.     REMUS.REV   - REMUS changes/revision history file
  86.     FILE_ID.DIZ - quick info file
  87.  
  88. - now you have REMUS successfully installed :-)
  89.  
  90.  
  91. REMUS IN ACTION:
  92. ----------------
  93.   For emulation are used protected mode features. When REMUS starts protected
  94. mode memory manager is initialized and takes control over memory, I/O, IRQ, DMA
  95. and Timer mechanisms. When REMUS is running, your sound card is used for
  96. emulation of some other sound card. In that time your original sound card is
  97. not available. Instead, you can even have emulated sound card on the ports
  98. where normally sits your real card. It's because your card is internally
  99. managed by REMUS's emulation routines and vm86 client's accesses are remaped
  100. into REMUS. REMUS can't be stopped, you have to reboot the computer after
  101. using it.
  102.  
  103.  
  104. DIALOG LINE:
  105. ------------
  106. Dialog line looks as following:
  107.   REMUS.EXE [/opt] base_card [/card_params] emu_card [/card_params]
  108.  
  109.   options:
  110.     /b - list of supported base cards
  111.     /e - list of available emulations
  112.  
  113. Current list of base cards will tell you what to put instead base_card
  114. parameter and same for emu_card.
  115. When you want for example Gravis Ultrasound with 768KB on port 240
  116. to be emulated on Sound Blaster on port 220, you have to use these params:
  117.   REMUS.EXE sblr /p220 gusc /p240 /m3
  118. and so on...
  119.  
  120.  
  121. AVAILABLE BASE CARDS:
  122. ---------------------
  123. These cards can be used for playing:
  124.  
  125. [adlb] - Adlib (OPL2)
  126.   Sound is generated by simulating 5-bit D/A converter. Sometimes sounds
  127. really weird.. accepts parameter /p (port), default value is 388.
  128.  
  129. [dacm] - D/A Converter
  130.   This is an 8-bit mono D/A converter. Can be created with minimal effords
  131. and its quality is not so bad. It's even very fast board. Accepts /p,
  132. default is 378.
  133.  
  134. [gusc] - Gravis Ultrasound
  135.   WaveTable board with noiseless sound. In REMUS are used only two voices
  136. offering stereo 16-bit D/A. Wavetable will be used later. It's quite fast
  137. board. Accepts /p (port + 100), default is 320.
  138.  
  139. [pcsp] - PC Speaker
  140.   Original beeper available on every system. REMUS uses it as primitive 6-bit
  141. mono D/A converter. Accepts /p (port), default is 42.
  142.  
  143. [sblr] - Sound Blaster
  144.   Board offering 8/16-bit mono/stereo sound depending on type. Here it's used
  145. as very slow mono 8-bit D/A converter (only minimal support now). Accepts /p
  146. (port), default is 220.
  147.  
  148.  
  149. AVAILABLE EMULATIONS:
  150. ---------------------
  151. More info about REMUS's emulation capabilities will come later, but now list
  152. of emulations would be fine:
  153.  
  154. [adlb] - Adlib (OPL2)      .. default: /p388
  155. [dacm] - D/A Converter     .. default: /p378
  156. [gusc] - Gravis Ultrasound .. default: /p220 /m4
  157.          * /mX   - memory size of emulated GUS in 256k banks
  158.          * on the base side there may be also /fX parameter for frequency
  159. [pcsp] - PC Speaker        .. default: /p42
  160. [sblr] - Sound Blaster     .. default: /p220
  161. [ston] - Stereo-on-1 DAC   .. default: /p378
  162.  
  163. There is option common to all of the emulations:
  164.   /pXXX - port number for emulated card
  165.  
  166.  
  167. GLOBAL EMULATION TABLE:
  168. -----------------------
  169. * - fully working (at least with most progs)
  170. # - nearly fully working (port/irq) except DMA emulation
  171. q - sound card is sometimes switched off and then no emulation works
  172. w - emulation engine is in progress but is useless right now
  173. ┌──────┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐
  174. │what  │ P │ D │ D │ 2 │ A │ A │ S │ S │ S │ P │ P │ T │ S │ V │ W │ G │ G │ I │ A │ G │ M │ S │ M │
  175. │   ──>│ C │ / │ / │ x │ D │ D │ B │ B │ B │ A │ A │ U │ N │ O │ S │ C │ U │ W │ W │ M │ T │ C │ A │
  176. │      │ S │ A │ A │ D │ L │ L │   │ P │ 1 │ S │ S │ R │ D │ C │ S │ O │ S │ A │ E │ I │ 3 │ C │ U │
  177. │      │ P │   │ S │ / │ I │ G │   │ R │ 6 │ 8 │ 1 │ T │ M │ M │   │ D │   │ V │ 3 │ D │ 2 │ 1 │ I │
  178. │where │ K │   │ T │ A │ B │   │   │ O │   │   │ 6 │ B │ 2 │ S │   │   │   │ E │ 2 │ I │   │   │   │
  179. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  180. │PCSPK │ *q│ *q│ *q│   │ wq│   │ #q│   │   │   │   │   │   │   │   │   │ #q│   │ wq│   │   │   │   │
  181. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  182. │D/A   │ * │ * │ * │   │ w │   │ # │   │   │   │   │   │   │   │   │   │ # │   │ w │   │   │   │   │
  183. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  184. │D/AST │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  185. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  186. │2xD/A │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  187. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  188. │ADLIB │ * │ * │ * │   │ * │   │ # │   │   │   │   │   │   │   │   │   │ # │   │ w │   │   │   │   │
  189. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  190. │ADLG  │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  191. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  192. │SB    │ * │ * │ * │   │ w │   │ # │   │   │   │   │   │   │   │   │   │ # │   │ w │   │   │   │   │
  193. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  194. │SBPRO │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  195. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  196. │SB16  │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  197. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  198. │PAS8  │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  199. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  200. │PAS16 │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  201. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  202. │TURTB │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  203. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  204. │SNDM2 │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  205. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  206. │VOCMS │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  207. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  208. │WSS   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  209. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  210. │GCODEC│   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  211. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  212. │GUS   │ * │ * │ * │   │ w │   │ # │   │   │   │   │   │   │   │   │   │ # │   │ w │   │   │   │   │
  213. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  214. │IWAVE │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  215. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  216. │AWE32 │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  217. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  218. │GMIDI │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  219. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  220. │MT-32 │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  221. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  222. │SCC-1 │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  223. ├──────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
  224. │MAUI  │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  225. └──────┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┘
  226.  
  227.  
  228. SOUNDCARD AND EMULATION INFO:
  229. -----------------------------
  230.  
  231.                         ───═══ AWE 32 board ═══───
  232.  
  233.   This is name of wavetable board created by a company Creative Labs, Inc.
  234.   It consists of standard Sound Blaster 16 board (refer to SB section) and
  235. advanced wavetable processor EMU-8000 made by a renomed company E-MU, Inc.
  236.   Chip is capable of managing 32 16-bit independent voices, each with
  237. its own 2 LFOs (low frequency oscillator), 2 EGs (envelope generator),
  238. low pass filter and reverb and chorus effects. Sounds are created from
  239. samples stored in internal memory space. EMU8000 can access up to 32MB of
  240. memory, however in AWE32 there is only 1MB dedicated for ROM (expandable
  241. to 4MB ??) and 512kB for RAM (expandable to 28MB). All voices are running
  242. at constant speed 44.1kHz, while their LFO's speed may vary from 0.042Hz
  243. to 10.72Hz and low pass filter's frequency from 100Hz to 8kHz. Whenever
  244. EMU accessess RAM data or is drived to pass FM music from OPL chip, it uses
  245. 2 voices to refresh RAM memory and for FM throughpass. In that case only 30
  246. voices are available for wavetable playing.
  247.   All effects for every voice and also some overall effects are made by
  248. an effect engine, which is right now UNDOCUMENTED. These effects include
  249. various Chorus, Hall and Reverb effects (for today, because effect engine
  250. probably offers some programmability for myriads of new effects).
  251.   AWE 32 hasn't dedicated MIDI engine managing EMU-8000 and therefore it
  252. has mechanisms for generating an NMI when something tries to access MIDI
  253. ports. Software driver running in memory can then simulate missing MIDI
  254. engine.
  255.  
  256.             ───═══ AWE 32 emulation engine specification ═══───
  257.  
  258.   Right now only some very basic port mechanisms are emulated. No sound
  259. yet nor any EMU-processor dependent function (EG/LFO/Filter counting etc.).
  260.   Apart of everything mentioned I can say effect engine will probably be
  261. never supported because of lack of ANY documentation and this task will
  262. also surely eat very much CPU power.
  263.  
  264.             ───═══ AWE 32 emulation engine compatibility ═══───
  265.  
  266.  Name            Author      Type    Status      Checked by   Comp    Ver
  267.  ────────────────────────────────────────────────────────────────────────
  268.  FXTweak         Infinity    util    ok run/quit RDOS         4/160  .03a
  269.  
  270.  
  271.                  ───═══ D/A converter on LPT port ═══───
  272.  
  273.   This is very simple board offering one D/A converter accessed via
  274. paralel port. It's not detectable and is simple to use. There are many
  275. circuits which can serve as D/A converter compatible boards. One of them,
  276. so-called "resistor DAC" is very very inexpensive. It's sound quality is
  277. not so bad. It's probably the best solution for REMUS users without any
  278. sound card. Its circuitry is described below.
  279.   Also some more advanced boards offer D/A compatibility. These boards are
  280. sometimes detectable and some games use their detection for enabling sounds.
  281. One of these boards is Covox Speech Thing and another one is called Disney
  282. Sound Source (this one probably offers something more but I have not info
  283. about it at all).
  284.  
  285.          ───═══ Circuitry of the D/A converter on LPT port ═══───
  286.  
  287.   You need one plug for your amp, one for your parallel port and 9 20k
  288. and 9 10K resistors. Use 1% resistors if possible ─ and 20k sound much
  289. better than 22k. The 100nF capacitor may not be needed, try removing it
  290. if this circuit sounds poor.
  291.  
  292.           Paralel Port:
  293.  
  294.           signal   pin        20k   20k
  295.           D0       2      >───███─┬─███──0v
  296.                               20k █ 10k
  297.           D1       3      >───███─┤
  298.                               20k █ 10k
  299.           D2       4      >───███─┤
  300.                               20k █ 10k
  301.           D3       5      >───███─┤
  302.                               20k █ 10k
  303.           D4       6      >───███─┤
  304.                               20k █ 10k
  305.           D5       7      >───███─┤
  306.                               20k █ 10k
  307.           D6       8      >───███─┤
  308.                               20k █ 10k
  309.           D7       9      >───███─┤
  310.                               20k █ 10k  100nF
  311.                                   ├──────┤█────> To amplifier
  312.                                   █ 10k
  313.           GND      20     >───────┼────────────>
  314.                                   0v
  315.  
  316.        ───═══ D/A converter emulation engine specification ═══───
  317.  
  318.   Fully working D/A emulation. Standard init port is 378h (LPT1).
  319.   Some check functions of Disney Sound Source are implemented.
  320.  
  321.        ───═══ D/A converter emulation engine compatibility ═══───
  322.  
  323.   Name            Author      Type    Status      Checked by   Comp    Ver
  324.   ────────────────────────────────────────────────────────────────────────
  325.   DMP 3.01        Otto Chrons player  ok          RDOS         4/66   .02a
  326.   Power Replay    M. Grof     player  ok          RDOS         4/66   .02a
  327.   Another World   Delphine    game    ok          RDOS         4/66   .02a
  328.   AnotherW Intro  TDT         intro   ok          RDOS         4/66   .02a
  329.   Fascination     Koktel      game    ok          RDOS         4/66   .02a
  330.   Gobliins        Koktel      game    ok          RDOS         4/66   .02a
  331.   Visual Player   many ppl    player  ok          RDOS         4/160  .03a
  332.   ModPlay Pro     Mark J.Cox  player  ok          RDOS         4/160  .03a
  333.  
  334.  
  335.                    ───═══ Gravis UltraSound board ═══───
  336.  
  337.   This is name of family of wavetable boards created by a company called
  338. Advanced Gravis Computer Technology Ltd.
  339.   Onboard pipeline chip named GF1 is capable of managing up to 32 16-bit
  340. independent voices (D/As) using samples stored in onboard RAM (256k-1MB).
  341. Sampling frequency depends on number of used voiced (14..32) and may
  342. vary from 44kHz down to 19kHz. Current voice position pointer in memory
  343. has fraction part and resulting sample is interpolated using that number.
  344. This leads to very high quality of produced sound even when using low
  345. frequency samples. For transfering samples to/from GUS's RAM, board's
  346. ports or DMA can be used. However, ports are not so fast as DMA that
  347. many products prefer DMA uploading.
  348.   Basic board had no sound source mixer while later versions came with
  349. ICS or other mixer. Later boards (Gravis UltraSound MAX) came also with
  350. special chip named CODEC for Digital Signal Processing. The newest card
  351. (Gravis UltraSound PnP) uses only one chip with built-in GF1, mixer and
  352. CODEC chip. This is AMD's InterWave chip and offers except standard GUS
  353. also up to 16MB ROM / 16MB RAM locally adressable memory, digital mixer
  354. for mixing voices together, 64 LFOs for tremolo/vibrato effects, effects
  355. processing for chorus/reverb/flange..., stable native frequency 44kHz.
  356. PnP's CODEC has independent sampling/playing rates, freqs up to 48kHz,
  357. very large FIFOs and more... GUS PnP (Pro) ships with 1MB ROM and
  358. 0kB (512kB) RAM expandable to 8MB (8,5MB) (via 30-pin SIMM slots).
  359.   All boards are not compatible with any other standard but are able to
  360. generate NMI (Non Maskable Interrupt) when some program access permitted
  361. ports. This process is used for emulating other platforms (namely
  362. Adlib (OPL2), Sound Blaster DAC or Roland MT-32/SCC-1 and General MIDI).
  363.  
  364.       ───═══ Gravis UltraSound emulation engine specification ═══───
  365.  
  366.   ALL functions of GF1 are emulated. Except this also onboard timer and
  367. IRQ generator are emulated. There is no DMA emulation now (buggy REMUS
  368. DMA manager !?!).
  369.   Sound is created via software GF1 pipeline emulation engine offering
  370. all features of GF1 (16-bit, uni/bidirectional loops, volume ramping,
  371. interpolation). Stopped voice is not emulated for speed reason (on
  372. original GUS it may be used as a simple D/A converter - but nearly isn't).
  373.   Software mixing of all voices is done at the same frequency as GF1 or
  374. at its multiplied derivate. Multiplication factor can be choosed during
  375. REMUS startup and may vary from 1/4 to 9/4 (Freq 11kHz- to Freq 99kHz-).
  376. Standard factor is 1=4/4 (Frequencies 44kHz - 19kHz like those found in GF1).
  377.   IRQ/DMA numbers are changeable using ULTRINIT (GUS utility). Standard
  378. setting is IRQ 11, DMA 5 (note that DMA manager in REMUS doesn't work now!).
  379.   Standard GUS port number is 220h.
  380.   GUS Memory is selectable (1-4: 256k, 512k, 768k, 1MB) and is allocated
  381. from available extended memory during REMUS inicialization. Standard value
  382. is 1MB memory (value 4).
  383.   NMI is not emulated (MEGAEM / SBOS don't work).
  384.   ICS, CODEC or whole InterWave chip are not emulated.
  385.  
  386.       ───═══ Gravis UltraSound emulation engine compatibility ═══───
  387.  
  388.   Name            Author      Type    Status      Checked by   Comp    Ver
  389.   ────────────────────────────────────────────────────────────────────────
  390.   Scream Trck 3   FC          medit   ok          RDOS         4/160  .01b
  391.   GusPlay 1.5     Cascada     player  ok          RDOS         4/160  .01b
  392.   Cartoon         MiST        64k     ok          RDOS         4/160  .01b
  393.   Debut           DarkZone    demo    ok          RDOS         4/160  .01b
  394.   Bill G Force    Complex     64k     ok, slow!?  RDOS         4/160  .02a
  395.   Oops!           Elf         64k     ok          RDOS         4/160  .02a
  396.   Louise          Karma       64k     ok          RDOS         4/100  .02a
  397.   Second Reality  FC          demo    ok, 1/2 spd RDOS         4/160  .01b
  398.   Big Deal        Acme        demo    - vcpi/dpmi RDOS         4/160  .01b
  399.   Cyboman 3       Hnut Loop   demo    - vcpi/dpmi RDOS         4/160  .01b
  400.   Flight          Sin         demo    ok          RDOS         4/160  .01b
  401.   Arrow           Grid        64k     ugh, chip?! RDOS         4/160  .01b
  402.   Shadow Team     Hirmu!      64k     ok          RDOS         4/160  .01b
  403.   Res. Rangers    Live!       64k     ok          RDOS         4/160  .01b
  404.   Shamaan         Complex     demo    ok          RDOS         4/160  .01b
  405.   Mind Plr 1.0    Nght Brkr   plr     ok          RDOS         4/160  .01b
  406.   Amoeba Plr 0.9  Amoebasoft  plr     ok          RDOS         4/160  .01b
  407.   Disorder 2      Statix      trckr   - vcpi      RDOS         4/160  .01b
  408.   Extreme 0.97b   Extreme     trckr   - vcpi      RDOS         4/160  .01b
  409.   GusDrive II     CCS-prod.   ramdsk  - blockdev  RDOS         4/160  .01b
  410.   C64S Emulator   M.Peternel  emultr  - silent    RDOS         4/160  .01b
  411.   PolyPlay        AcmE        plr     ptrn skip   RDOS         4/100  .02a
  412.   Crystal Player  S.Grandjoux plr     ok          RDOS         4/100  .02a
  413.   DMP 4.01        Otto Chrons plr     ok, w/o dma RDOS         4/100  .02a
  414.   Digital Plr Pro             plr     - irq/dma   RDOS         4/100  .02a
  415.   Impulse Tracker Jeffrey Lim trckr   ugh, lo spd RDOS         4/100  .02a
  416.   SSS             Legend Des. plr     ok          RDOS         4/160  .02a
  417.   SidPlay 1.40a   M.Schwendt  plr     - Exception RDOS         4/160  .03a
  418.   BBStro          Dig.Design  intro   ok          RDOS         4/160  .03c
  419.   BNP             Blue Nose   intro   ok          RDOS         4/160  .03c
  420.   The One         Eclipse     intro   ok          RDOS         4/160  .04d
  421.   TDU Jam         Dream Dsgn  intro   ok          RDOS         4/160  .04d
  422.   Joe Mix         TPOLM       demo    ok          RDOS         4/160  .04e
  423.  
  424.  
  425.                          ───═══ PC Speaker ═══───
  426.  
  427.   Although PC compatible systems are equipped with no sound board at all,
  428. the simple thing that makes your PC beep, can also be programmed to
  429. substitute weird D/A (6-bit) to produce digitized sound. Some programs
  430. (the older ones) have used this capability to produce digitized sounds or
  431. some music.
  432.  
  433.          ───═══ PC Speaker emulation engine specification ═══───
  434.  
  435.   Emulated PC Speaker is always switched to digital which is fully emulated.
  436. No beeping can be done. Digital PC Speaker emulation is not as bad as someone
  437. may believe, because it's often done on real D/A converters and 6-bit Speaker
  438. value is expanded to 8/16-bit equivalent instead.
  439.  
  440.          ───═══ PC Speaker emulation engine compatibility ═══───
  441.  
  442.   Name            Author      Type    Status      Checked by   Comp    Ver
  443.   ────────────────────────────────────────────────────────────────────────
  444.   DMP 3.01        Otto Chrons player  ok          RDOS         4/66   .04a
  445.   ModPlay Pro     Mark J.Cox  player  ok          RDOS         4/160  .04a
  446.   Inertia Player  Inertia     player  ok          RDOS         4/66   .04a
  447.  
  448.  
  449.                    ───═══ Sound Blaster board ═══───
  450.  
  451.   This is name of family of boards created by Creative Labs, Inc.
  452. Sounds are made via onboard D/A converter. To make things easier there
  453. is a DSP (Digital Signal Processor) which accepts some commands. These
  454. commands are used to set up some parameters on the card or send digital
  455. data to the D/A converter. When multichannel music is needed, it's up to
  456. the program to mix channels together and then send result to only ONE
  457. D/A converter on the board. Some new boards of this type use two D/As,
  458. every of them assigned to one side (left/right) for stereo music. Basic
  459. board is capable of making 8-bit mono sound while the newest can cope
  460. with 16-bit stereo samples (two 16-bit D/As). The board also supports
  461. so-called DMA channel for sending data to D/A without CPU usage. 16-bit
  462. board has to have two DMAs, one 8-bit and one 16-bit. For proper work
  463. of DMAs, an IRQ is needed (It informs computer that DMA process has ended).
  464. On 8-bit boards DMA and IRQ numbers are set with onboard jumpers while
  465. on 16-bit boards DMA and IRQ numbers are runtime changeable.
  466.   On some 16-bit boards there is another chip called CSP (old ASP). It is
  467. short term for Advanced Signal Processor which is mainly used to compress
  468. recorded stream of data or for voice recognition. Documentation for this
  469. chip has never been released and therefore it will never be support for it
  470. in REMUS (probably).
  471.   Apart of this, there is also an onboard OPL2 chip for Adlib compatibility
  472. (refer to FM/OPL emulation). On SB Pro 1 there were two OPL2 chips for stereo
  473. music available, each of them for one side. Since SB Pro 2 there is only
  474. one OPL3 stereo chip capable of more advanced, 4-operator FM music.
  475.   All boards are backward compatible down to Sound Blaster 1.0.
  476.  
  477. These board versions are known:
  478.  
  479.      ──══ Name ══──        ───═══ DAC specification ═══───     ─═ DSP ═─
  480.   ┌───────────────────┬────────┬────────┬─────────────────────┬─────────┐
  481.   │ Sound Blaster 1.x │   mono │  8-bit │ up to 11kHz         │   1.0x  │
  482.   ├───────────────────┼────────┼────────┼─────────────────────┼─────────┤
  483.   │ Sound Blaster 2.0 │   mono │  8-bit │ up to 22kHz         │   2.0x  │
  484.   ├───────────────────┼────────┼────────┼─────────────────────┼─────────┤
  485.   │ Sound Blaster Pro │ stereo │  8-bit │ up to 22kHz / 44kHz │   3.0x  │
  486.   ├───────────────────┼────────┼────────┼─────────────────────┼─────────┤
  487.   │ Sound Blaster 16  │ stereo │ 16-bit │ up to 44kHz         │   4.xx  │
  488.   └───────────────────┴────────┴────────┴─────────────────────┴─────────┘
  489.  
  490.       ───═══ Sound Blaster DAC emulation engine specification ═══───
  491.  
  492.   Right now only port and IRQ emulation works. Emulated DSP version is
  493. 1.01 with some check functions from 3.xx DSP (SBPro's DIAGNOSE works :-).
  494. IRQ number is not selectable and is permanently set to IRQ10 (lower IRQs
  495. do not work for some strange reason - ie. REMUS IRQ manager bug??).
  496.   Don't even think about DMA emulation. REMUS's DMA manager is unusable.
  497.  
  498.       ───═══ Sound Blaster DAC emulation engine compatibility ═══───
  499.  
  500.   Name            Author      Type    Status      Checked by   Comp   Ver
  501.   ───────────────────────────────────────────────────────────────────────
  502.   SBPro Diagnose  Creat.Labs  util    ok (DMA-)   RDOS         4/33  .03a
  503.   Another World   Delphine    game    ok          RDOS         4/33  .03a
  504.   AnotherW Intro  TDT         intro   ok          RDOS         4/33  .03a
  505.   ModPlay Pro     Mark J.Cox  player  ok          RDOS         4/160 .03a
  506.  
  507.  
  508. FUTURE PLANS (Global targets):
  509. ------------------------------
  510. * EMS support
  511.   - memory paging manager for RPMMM needed first
  512.  
  513. * DPMI support
  514.   - probably 32-bit clients only
  515.   - minimal functions, but at least those needed by Tran's PMODE extender
  516.   - at the beginning buggy stack management (I don't understand it now)
  517.  
  518. * complete move in protected mode
  519.   - right now are base card inits in real mode (really messy, isn't it? :)
  520.  
  521. * total modularity
  522.   - one code for one emulation target at the binary level (now only on
  523.     source level, during compilation distributed throughout bases)
  524.  
  525. * online settings menu
  526.   - with runtime-changeable emulations, memory options, maybe disassembler
  527.  
  528. * coprocessor usability
  529.   - FPU is now detectable, but generates Divide by zero error when accessed
  530.  
  531. * Pro-Pack error solving
  532.   - now Pro-packed files definitely hang computer (why?! not under debugger!)
  533.  
  534. FUTURE PLANS (Emulation targets):
  535. ---------------------------------
  536. * full Sound Blaster emulation
  537.   - DMA manager is not functional - DMA support is not possible now :-((
  538.   - stereo
  539.   - 16-bit
  540.  
  541. * Adlib (OPL2) emulation
  542.   - realtime FM digital emulation is very very hard thing to do :-)
  543.  
  544. * OPL3 emulation
  545.   - Depends on OPL2 emulation, would probably need the most CPU power
  546.     ever seen.
  547.  
  548. * Gravis Ultrasound DMA/IRQ handling emulation
  549.   - should work but doesn't now .. flame must go to REMUS DMA Manager
  550.  
  551. * Gravis UltraSound PnP emulation (AMD InterWave wavetable chip)
  552.   - synthesizer part will be probably first
  553.   - time for work... (have very complete documentation)
  554.   - its digital mixer is very interesting thing (and hard to emulate)
  555.  
  556. * Sound Blaster AWE32 emulation (EMU8000 wavetable chip)
  557.   - time for work... (have documentation for main pipeline processor)
  558.   - some documentation for EMU's effects engine needed
  559.     (dummy chaos of data arrays sent to card really does not tell anything)
  560.   - probably the hardest emulation I've ever seen
  561.  
  562. * Roland MT-32 / Roland Sound Canvas / General Midi emulation (wavetable chips)
  563.   - documentation for SYSEXes needed
  564.   - really explaining documentation for all the wheels and other effects
  565.  
  566.  
  567. REMUS FREQUENTLY ASKED QUESTIONS:
  568. ---------------------------------
  569. * REMUS hangs up after initialization
  570.   - if you have more than 16MB RAM, REMUS will not work (for now)
  571.   - if you have some memory manager incompatible with INT15 or HIMEM running,
  572.     REMUS will not work
  573.   - if you don't have XMS driver loaded and some application uses Xmemory
  574.     via INT15 BIOS services, computer hangs when REMUS starts and this
  575.     application will try to access that Xmemory (for example Norton Cache)
  576.  
  577. * REMUS does not want to run with PM driver (EMM386/QEMM/Win) installed in mem.
  578.   - REMUS is clean 32-bit PM manager. It needs completely free environment to
  579.     operate. Therefore other PM managers will NEVER be supported in REMUS.
  580.     REMUS is from the beginning meant as a complete memory manager so it's
  581.     internal functionality is absolutely incompatible with anything other
  582.     (even VCPI's ProtMode level 0).
  583.  
  584. * When I install REMUS there is no EMS memory in system. Some of my programs
  585.   don't want to run at all.
  586.   - EMS services are not yet supported by REMUS, sorry...
  587.  
  588. * My application told me I have no VCPI compatible environment and refused
  589.   to run when I started it under REMUS.
  590. * My application refused to run with exit message about impossibility to enter
  591.   DPMI protected mode.
  592.   - VCPI/DPMI are 32-bit Protected mode interfaces allowing your applications
  593.     to run 16/32-bit protected mode code under other 32-bit PM environment
  594.     installed in memory. Although these ifaces are not yet supported under
  595.     REMUS, there exist light of hope that DPMI will be supported in far far
  596.     future. Right now DPMI interface is provided to ensure clients using it
  597.     won't hang computer via their lame PM detection (ie. Borland's dpmiload).
  598.  
  599. * How much system memory takes REMUS for its work ?
  600.   - REMUS takes about 1k of conventional mem. In fact, everything is now in
  601.     Xmemory (above 1MB) and takes there about 25kB-1050kB depending on current
  602.     running emulation. But Xmemory requirements probably don't bother anyone.
  603.  
  604. * GUS emulation is sometimes STRANGE !! often "ultraclicks" or noise occurs !!
  605.   - The noise is generated due GUS emulation sampling frequency. Try to use
  606.     at least 75% (33kHz) or more of GUS real sampling speed. Emulation engine
  607.     is rather old and I'll probably try to make completely new engine some day.
  608.     Maybe then also those painful ultraclicks disapper.
  609.  
  610. * emulations on SB are really slow, sometimes computer hangs up.
  611.   - Because of SB port speed emulations work fine up to about 20kHz. Above
  612.     this limit SB reply is too slow and machine often hangs up. This problem
  613.     will disappear after making DMA manager and DMA-using SB support.
  614.  
  615. * all emulations on PCSP are sometimes useles (quiet).
  616.   - In some programs PC Speaker is switched off and then no emulation works
  617.     (speaker is simply quiet).
  618.   - This is fault of my PCSP-driver and will be corrected in one of the next
  619.     versions of REMUS.
  620.   - example: Fascination game by Koktel vision.
  621.  
  622. * I've heard Disney Sound System sound card is something like D/A converter.
  623.   Is it right ? And what about Covox Speech Thing ?
  624.   - Those cards offer standard DAC on LPT compatibility, but they have
  625.     probably also some DMAs or other things for faster playback. I have no
  626.     documentation about them and also some good programs to test functionality.
  627.   - Already working example: Another World game by Delphine software (DAC LPT)
  628.   -     Not working example: Wolfenstein 3D game by ID software (DMA DAC ??)
  629.  
  630. * I've seen there are some strange emulations (for example: D/A on D/A). What
  631.   are they for ?
  632.   - these emulations are for people owning the right sound card but on another
  633.     port / IRQ / DMA they need...
  634.  
  635. * Could I use D/A -> D/A emulation for redirecting printer to another LPT ?
  636.   - No, generally not. Emulation works only for D/A output, LPT control port
  637.     emulation is designed to work moreless like Covox/Disney Sound Source's
  638.     LPT DACs, not like I/O ports of standard printer port.
  639.  
  640. * Some emulations are generally quite slow. What's the problem ?
  641.   - With some soundcards emulation could not be fast because of their speed.
  642.   - Some emulated sound cards are so hard to emulate (example: GUS) that the
  643.     emulation is getting to be quite slow.
  644.   - Protected Mode system exception handling eats some system resources
  645.     so even simple emulations are slower than should be.
  646.     - example: D/A converter on D/A converter.
  647.  
  648. * I've realised that all IRQ and DMA emulations don't work. Am I right ? Why ?
  649.   - yes, they don't work. Some nasty bugs in REMUS's IRQ/DMA manager cause
  650.     that all emulations which need some IRQ or IRQ/DMA don't partially or
  651.     completely work. IRQ/DMA is currently needed for emu_GUSC and emu_SB.
  652.  
  653. * Hey guy, where is my card in the list of supported soundcards ? How you dare
  654.   my soundcard is not supported ?
  655.   - That's not my fault. Your card will be supported if I get enough info
  656.     about it and some program which uses it (for testing). Then I would
  657.     probably include it in REMUS. Also one piece of that card borrowed would
  658.     greatly improve implementing.
  659.  
  660. * Ugh, why is some card listed in emulations but is not supported as base ?
  661.   - That's simple. I would probably not include any sound card support as base
  662.     until I get it for testing. But emulation fuctionality I can easily test
  663.     in available programs by setuping them to that card.
  664.  
  665. * Hey boy, I wanna emulation of XY$@#325 sound card and there is none. What
  666.   should I do for it ?
  667.   - First you should look in the FUTURE section to know the status of that
  668.     card. If you find no progress of that card there, you should look for
  669.     some programming info about that sound card and then you can send me this
  670.     info and the program which works with that sound card (for testing).
  671.     If you don't find any programming info you can still send me the program
  672.     that uses it and i'll try luck and debug that piece of code.
  673.     But in both cases don't expect fast response - I'm really really lazy :-)
  674.     Basic block of emulation takes me about 2-3 days to complete but really
  675.     powerfull and featured emulation takes me about next half year of my lazy
  676.     programming :-)
  677.  
  678.  
  679. WHERE TO FIND REMUS:
  680. -----------------------
  681. Each time I have a new version of REMUS available, I'll upload it to:
  682.  
  683.  ftp://sorry.vse.cz/dimension   (Dimension FTP site in Prague, Czech Republic)
  684. http://sorry.vse.cz/dimension   (Dimension Inet HeadQuarters, Czech Republic)
  685.  
  686. REMUS will be probably also available at ftp.cdrom.com and ftp.sunet.se
  687. FTP archives.
  688.  
  689.    Ask your local Internet or FTP expert on how to reach them.
  690.  
  691. Another way is to visit REMUS's homepage at address:
  692.  
  693.    http://sorry.vse.cz/dimension/rdos/remus   (Http site in Prague, CZE)
  694.  
  695.  
  696. THANX:
  697. ------
  698.  
  699. Although I did all the programming, there are few friends which helped me with
  700. some things about this program. Thanx go to:
  701.  
  702. Ondrej Stasek (Ondar/Dimension) - testing and suggestions
  703. David Voracek (Assassin/Dimension) -     - || -
  704.  
  705. and other friends for their (mostly) betatesting and suggestions..
  706.  
  707.  
  708. CONTACTING ME:
  709. --------------
  710.   If you want to contact me, write to address listed below. If you want to send
  711. me suggestions, tips or simply greets, send it freely. Also some money would be
  712. good as a power and motivation for further work :-) If you find any new sndcard
  713. and its programming info you can also send it to me (the info). Nice would be
  714. also any report of success in functionality of REMUS. Don't forget many
  715. reactions will bring me in new effort in this rather old project.
  716.  
  717. My address:                           E-Mail: (non-commercial)
  718.   Roman Dolejsi (RDOS)                    roman@sorry.vse.cz
  719.   Husova 419, Vcelna                      roman@romeo.pf.jcu.cz
  720.   37382 Ceske Budejovice
  721.   Czech Republic
  722.  
  723. Please do not send me E-mails longer than 150kB (because of our local smtp
  724. server limit).
  725.  
  726. *** end of REMUS documentation ***